home *** CD-ROM | disk | FTP | other *** search
/ GRAVIS Top 100 #5 / GRAVIS CD No5_Herbst_95.cdr / GRAVIS / PD ⁄ Shareware / System-Tools / FaberFinder 4.1.4 / FaberFinder docs < prev    next >
Text File  |  1995-07-11  |  13KB  |  121 lines

  1. Fabrizio Oddone
  2. C.so Monte Cucco 59/F
  3. 10141 Torino
  4. Italy
  5.  
  6. FaberFinder™ documentation
  7.  
  8. This document has styles in it. You may view them with a text editor such as Tex-Edit by Tom Bender or Style (1.2.1 or later) by Marco Piovanelli, or Apple SimpleText by Tom Dowdy.
  9.  
  10. •    SHAREWARE - US$5
  11. ◊    This program is distributed as Shareware: if you use it, you should pay the author. You may register:
  12. - with the bundled Register application, or
  13. - directly to me by sending cash (US$ or an equivalent sum with your local currency) or an international (postal) money order; if you would rather pay using a different method, try the Register application.
  14. ◊    NOTE: Getting a note, a postcard or anything else is a lot better than getting nothing. I would like to know how far this program has gone, so remember that you can do something nice even if you do not have a couple of $ to spare.
  15.  
  16. •    SYSTEM REQUIREMENTS
  17. ◊    FaberFinder needs the Hierarchical File System (HFS), always present on the Mac Plus or later Macs; I cannot remember if Apple released a System able to add HFS to the Mac 128 or 512. It works (at least) on my old, faithful Mac Plus under System 1.1, 2.0, 4.0, 4.3, 6.0.2, 6.0.8; you can use it under System 7.0 or later, but System 7 is not fully supported: you cannot launch desk accessories from the directory dialog box.
  18. Under Systems older than 4.0 the Special menu is disabled, because the System does not implement the Shutdown Manager. To restart your Mac, eject all the disks with the Eject button in the directory dialog box, then hit the reset button on the left side of your Mac. To shut down, eject the disks, then power off the Mac with the on/off switch.
  19.  
  20. •    GENERAL INFO
  21. I have included two copies of FaberFinder, identical in all but the type and creator: one to be used as a normal application, one to be used instead of the Finder. FaberFinder may be useful for emergency disks, where space is at a premium.
  22. Important note for making System 7 emergency disks: simply putting FaberFinder disguised as the Finder in the System folder does not work. That is, when you boot with the disk and try launching an application, the Mac hangs. To build a valid bootable disk, you need ResEdit.
  23. - Open the file named System with ResEdit. You may want to apply the modifications on a copy of this System, stored on your local hard disk, and copy it later on the floppy. Remember the resource 'boot' #1 size. Open the resource 'boot' #1. The go-ahead readers will try copying the text from the rightmost column below and pasting into ResEdit. It does not work (left as an exercise to the reader); try with the leftmost column instead.
  24. You should see something like this:
  25.  
  26. 4C4B600000864418 LK`ÜD
  27. 0000065379737465 Syste
  28. 6D00000000000000 m
  29. 00000646696E6465  Finde
  30. 7200000000000000 r   
  31. 0000074D61637342  MacsB
  32. 7567000000000000 ug
  33.  
  34. Change it so that it shows like this (changed parts are underlined, if you have SimpleText):
  35.  
  36. 4C4B600000864418 LK`ÜD
  37. 0000065379737465 Syste
  38. 6D00000000000000 m
  39. 00000B4661626572  Faber
  40. 46696E6465720000 Finder 
  41. 0000074D61637342  MacsB
  42. 7567000000000000 ug
  43.  
  44. Now you are ready to close the resource and check the resource 'boot' #1 size. Is it the same as before? Go ahead, close your System, saving the changes. If the size has changed, revert the resource and start over.
  45. - Eject the disk, just to be sure the changes have taken effect.
  46. - Reinsert the disk, opening its System folder. Inside the System folder: the modified System, the FaberFinder disguised as the Finder (named “Finder”) instead of the Apple Finder. The System folder (and the special folders inside it) should show their special icons. If this does not happen, close and reopen the System folder.
  47. - rename “Finder” to “FaberFinder”.
  48. The disk should boot fine, and FaberFinder will not hang when launching applications.
  49.  
  50. •    THE TALE
  51. I started writing FaberFinder in 1988, I think. I had a Plus with two 800K floppy drives. Disk space was at a premium, so I decided to get rid of the Finder on some of my startup disks. More fonts, more extensions, more everything. Unfortunately, I had no Internet access (nor I did know Internet existed!), so the rest of the world had to live without FaberFinder. The very first version saw the light when System 4.0 was still in the works (remember? the first release with the Shutdown Manager…). Then came System 4.1 (remember? the one that introduced the arrows in the menus, hierarchic menus and the first routines for handling the popup menus), then, … then MultiFinder came, then System 6…
  52. I even wrote a version history and a “Read me” document, shown below. Then the development stopped at 4.0.1. Then I lost both the latest source file, documentation, and assembled application. Even my friends lost their copy of FaberFinder 4.0.1, so I could not, at least, recover the source by disassembling the application.
  53. Time passes…
  54. Eventually, in November 1993 I found a copy of FaberFinder 4.0 and its documentation. I juggled again with the assembly code and FaberFinder 4.1 is here.
  55.  
  56. •    THE OLD READ-ME
  57. This program has been written to save time. In fact loading the Finder takes a lot of precious time, even if you have the cache memory turned on. FaberFinder (FF for short) loads in few seconds, due to the fact it is only 3K (less than this documentation).
  58. You can simply launch applications as if you were opening documents. The user can freely select menus also when the directory dialog box is opened. Note that when you choose a desk accessory such as the Calculator, the directory dialog box disappears. This has been done to avoid a terrifying BOMB!
  59. Peeking at the resources with ResEdit, you can see a ‘STR ’ 128; here is the name of the desk accessory you may open at startup. This name is set to ‘ DiskTop’, but can be modified as you wish. The white space I left before the string is an ASCII code 0, which is absolutely necessary; if it is not present, the desk accessory will not open. When changing this string with ResEdit, make sure you are not clearing this invisible character, to prevent undesirable madness. If you want to bypass the “Open desk accessory” feature temporarily, hold the mouse button down while FF is loading, and the directory dialog box will be presented instead. Obviously, if the desk accessory with that name is not present in the Apple menu, or if the ‘STR ’ resource itself has been deleted, FF will bypass this feature automatically.
  60. The launched application WILL RETURN to FF, no matter where FF is located on disks. This feature, technically called sublaunch, is available only with System 4.1 or later. System 4.0 and earlier have not this capability. If you want to return to the true Finder, you have to keep the Command key down while quitting from an application.
  61. System switch option: the directory dialog box lets you select the Apple Finder. If you launch the Finder or another application named ‘Finder’, FF will switch the system to that disk, looking if the ‘System’ file is present. Note that in this way you cannot launch applications named ‘Finder’, unless there is a ‘System’ in that folder. FF also checks if the Finder you are launching is on the current system disk; in this case you will simply quit to the Finder. Please note that to switch systems you MUST launch an application named ‘Finder’: launching an application on a startup disk will not lead to a system switch.
  62. Note for Suitcase II™ users: Steve Brecher’s masterpiece (version 1.2.2) still has a bug. If you switch systems, apparently all is perfect, on the contrary the FF file is still open, so you cannot re-launch it, and the Suitcase II file remains also open.
  63. Note for SFVol users: this little utility (version 1.5) has a nasty bug. Keep the directory dialog box open, call Suitcase II, press Command-O; exiting Suitcase you get a bomb ID=2, but only if you are using Lau’s extension.
  64. For other features, read the program development section.
  65.  
  66. •    DISCLAIMER
  67. ◊    “No warranties at all, either express or implied…” “All trademarks are held by their respective owners…” and all that stuff.
  68. This application should do no damage, but if it does then you will be on your own. Let me know of any bugs you run into, anyway.
  69.  
  70. •    VERSION HISTORY:
  71. 1.0
  72. First Release, written in Pascal.
  73. 2.0
  74. Program was entirely rewritten to allow menu selections ALWAYS; first assembly optimizing.
  75. 2.0.1
  76. Bug fix: clicking on the menu bar or choosing a menu while the directory dialog box was open caused a nonsense-beep from the speaker.
  77. 3.0
  78. Added open desk accessory on startup & Finder substitution; code optimized.
  79. 3.0.1
  80. Bug fix: if the user pressed the Option key in order to return to FF while it was NOT in the System Folder caused problems: when quitting from the application just launched, the System forced you to restart. (Could not find FF).
  81. 3.0.2
  82. Bug fix: choosing a desk accessory, then Launch…, and then selecting the desk accessory window caused a system error; now the directory dialog box automatically disappears.
  83. 3.1
  84. True sub-launching feature added, with Command key instead of Option key (System 4.1 or later).
  85. 3.2
  86. Added ‘System switching’ feature, but it does not work well.
  87. 3.2.1
  88. Now FF does more tests before system-switching; it now works much better than before. Info DLOG was changed to an ALRT to save code.
  89. 3.2.2
  90. If the user attempted to insert a damaged or unreadable disk while the directory dialog box was not open, the Mac did not ask for initializing; this was fixed. Remember the Command-key feature? Now, instead of waiting the next launch, FF returns directly to the Finder if that key is pressed while loading. Furthermore, FF checks if there is enough memory to open a desk accessory. If not, you will hear a beep from the speaker. You can also hear this short beep, choosing a DA with the System disk ejected, then pressing Command-. to cancel the opening of the DA. When running under System 6.0.2 the stupid _GetNextEvent trap asks again for the disk; INSERT IT if you do not want a System Error ID=23. No problem with earlier systems: only a beep.
  91. 3.2.3
  92. V3.2.2 introduced a bug in opening DAs: in the attempt of looking for free space in memory, I made a “handle” which was not disposed of correctly. So asking M times for a DA whose code is N Kbytes big, caused a memory waste of (M-1)*N Kbytes. This was particularly pernicious with enormous DAs like McSink or DiskTop. Now the DAs occupy only the space they need (and the memory checking is still valid). ‘vers’ resources added.
  93. 3.3
  94. FF now closes all open DAs before quitting, launching, or shutting down. To verify the effectiveness of this feature you can modify a document with a DA like DeskPaint™ or Vantage™ and quit. The DA will ask if you want to save changes.
  95. 3.4
  96. The directory dialog box is centered on larger screens too. In the info ALRT, the two static text items were merged into only one item; this saved ten bytes at least. Two “byte-saving” modifications on code.
  97. 4.0
  98. Now fully MultiFinder friendly! Size increases to 2.5K. FF under the Finder works exactly the same as before (although memory management is better).
  99. New 4.0 features:
  100. holding down the shift key while choosing Launch… shows all files, allowing you, for instance, to launch MultiFinder;
  101. auto-opening a desk accessory is not tried if under MultiFinder;
  102. it is possible to work with MultiFinder but without the Finder: put FF in the System Folder (otherwise MultiFinder will complain), set FF as startup application (with Finder selected, not MultiFinder), then launch MultiFinder as described before;
  103. the about box shows the application heap maximum free block of memory if running under the Finder, the maximum free block available to applications with MultiFinder, which was more than 800K on my lowly Mac Plus with 1Meg of RAM!
  104. 4.1
  105. Added a confirmation dialog if you restart or shut down when MultiFinder is running. You can bypass this dialog by holding down the shift key.
  106. Now more System 7.0 compliant. Does not call _MaxApplZone if running on the old 64K ROM Macs (however, I cannot tell if it will run or not, because I have no 64K ROM Mac to test with).
  107. 4.1.1
  108. A couple of modifications suggested by Alessandro Levi Montalcini.
  109. 4.1.2
  110. Maintenance release.
  111. 4.1.3
  112. Fixed the docs and added the Finder-disguised copy; thanks to Ashley Barnard (AMUG) who first noticed my mistake.
  113. 4.1.4
  114. Changed the suggested memory partition. Includes the Register application.
  115.  
  116. •    THANKS TO…
  117. ◊  Federico Cavaglià, for his invaluable ß-testing & bug reports.
  118.  
  119. To report errors, suggestions, or whatever, send e-mail to fab@kagi.com
  120.  
  121. – Fabrizio Oddone